home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / SCSL / stbtrs.z / stbtrs
Encoding:
Text File  |  2002-10-03  |  4.3 KB  |  133 lines
  1.  
  2.  
  3.  
  4. SSSSTTTTBBBBTTTTRRRRSSSS((((3333SSSS))))                                                          SSSSTTTTBBBBTTTTRRRRSSSS((((3333SSSS))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      STBTRS - solve a triangular system of the form  A * X = B or A**T * X =
  10.      B,
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      SUBROUTINE STBTRS( UPLO, TRANS, DIAG, N, KD, NRHS, AB, LDAB, B, LDB, INFO
  14.                         )
  15.  
  16.          CHARACTER      DIAG, TRANS, UPLO
  17.  
  18.          INTEGER        INFO, KD, LDAB, LDB, N, NRHS
  19.  
  20.          REAL           AB( LDAB, * ), B( LDB, * )
  21.  
  22. IIIIMMMMPPPPLLLLEEEEMMMMEEEENNNNTTTTAAAATTTTIIIIOOOONNNN
  23.      These routines are part of the SCSL Scientific Library and can be loaded
  24.      using either the -lscs or the -lscs_mp option.  The -lscs_mp option
  25.      directs the linker to use the multi-processor version of the library.
  26.  
  27.      When linking to SCSL with -lscs or -lscs_mp, the default integer size is
  28.      4 bytes (32 bits). Another version of SCSL is available in which integers
  29.      are 8 bytes (64 bits).  This version allows the user access to larger
  30.      memory sizes and helps when porting legacy Cray codes.  It can be loaded
  31.      by using the -lscs_i8 option or the -lscs_i8_mp option. A program may use
  32.      only one of the two versions; 4-byte integer and 8-byte integer library
  33.      calls cannot be mixed.
  34.  
  35. PPPPUUUURRRRPPPPOOOOSSSSEEEE
  36.      STBTRS solves a triangular system of the form A * X = B or A**T * X = B,
  37.      where A is a triangular band matrix of order N, and B is an N-by NRHS
  38.      matrix.  A check is made to verify that A is nonsingular.
  39.  
  40.  
  41. AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  42.      UPLO    (input) CHARACTER*1
  43.              = 'U':  A is upper triangular;
  44.              = 'L':  A is lower triangular.
  45.  
  46.      TRANS   (input) CHARACTER*1
  47.              Specifies the form the system of equations:
  48.              = 'N':  A * X = B  (No transpose)
  49.              = 'T':  A**T * X = B  (Transpose)
  50.              = 'C':  A**H * X = B  (Conjugate transpose = Transpose)
  51.  
  52.      DIAG    (input) CHARACTER*1
  53.              = 'N':  A is non-unit triangular;
  54.              = 'U':  A is unit triangular.
  55.  
  56.      N       (input) INTEGER
  57.              The order of the matrix A.  N >= 0.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SSSSTTTTBBBBTTTTRRRRSSSS((((3333SSSS))))                                                          SSSSTTTTBBBBTTTTRRRRSSSS((((3333SSSS))))
  71.  
  72.  
  73.  
  74.      KD      (input) INTEGER
  75.              The number of superdiagonals or subdiagonals of the triangular
  76.              band matrix A.  KD >= 0.
  77.  
  78.      NRHS    (input) INTEGER
  79.              The number of right hand sides, i.e., the number of columns of
  80.              the matrix B.  NRHS >= 0.
  81.  
  82.      AB      (input) REAL array, dimension (LDAB,N)
  83.              The upper or lower triangular band matrix A, stored in the first
  84.              kd+1 rows of AB.  The j-th column of A is stored in the j-th
  85.              column of the array AB as follows:  if UPLO = 'U', AB(kd+1+i-j,j)
  86.              = A(i,j) for max(1,j-kd)<=i<=j; if UPLO = 'L', AB(1+i-j,j)    =
  87.              A(i,j) for j<=i<=min(n,j+kd).  If DIAG = 'U', the diagonal
  88.              elements of A are not referenced and are assumed to be 1.
  89.  
  90.      LDAB    (input) INTEGER
  91.              The leading dimension of the array AB.  LDAB >= KD+1.
  92.  
  93.      B       (input/output) REAL array, dimension (LDB,NRHS)
  94.              On entry, the right hand side matrix B.  On exit, if INFO = 0,
  95.              the solution matrix X.
  96.  
  97.      LDB     (input) INTEGER
  98.              The leading dimension of the array B.  LDB >= max(1,N).
  99.  
  100.      INFO    (output) INTEGER
  101.              = 0:  successful exit
  102.              < 0:  if INFO = -i, the i-th argument had an illegal value
  103.              > 0:  if INFO = i, the i-th diagonal element of A is zero,
  104.              indicating that the matrix is singular and the solutions X have
  105.              not been computed.
  106.  
  107. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  108.      INTRO_LAPACK(3S), INTRO_SCSL(3S)
  109.  
  110.      This man page is available only online.
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.